Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 17 - File Objects / File Objects Reference

File Objects Routines / Managing Unknown Objects

Q3UnknownBinary_GetData

You can use the Q3UnknownBinary_GetData function to get the data of an unknown binary object.

TQ3Status Q3UnknownBinary_GetData (
TQ3UnknownObject unknownObject, 
TQ3UnknownBinaryData *unknownBinaryData);

unknownObject

An unknown binary object.

unknownBinaryData

A pointer to an unknown binary data structure.

DESCRIPTION

The Q3UnknownBinary_GetData function returns, in the contents field of the unknown binary data structure pointed to by the unknownBinaryData parameter, a pointer to a copy of the contents of the unknown binary object (that is, an unknown object of type kQ3UnknownTypeBinary) specified by the unknownObject parameter. Q3UnknownBinary_GetData also returns, in the objectType and size fields of the unknown binary data structure, the type of the unknown binary object and the size, in bytes, of the data pointed to by the contents field.

Your application is responsible for allocating the memory occupied by the unknownBinaryData parameter. Q3UnknownBinary_GetData allocates memory to hold the data pointed to by the contents field of that structure. You must make certain to call Q3UnknownBinary_EmptyData to release the memory allocated by Q3UnknownBinary_GetData when you are finished using the data.